curlコマンドでJSONデータをAPIにPOSTする

APIの動作確認をしたいときに使えます。

今回はAPIのURIをlocalhost:5000/api/v1/とします。また、v1の後の文字列でリクエスト先を定義します。(例: ユーザ登録... localhost:5000/api/v1/users)

-X POST : POSTでリクエストを投げるときに使います。

-H : リクエストヘッダを指定する時に使います。 今回はリクエストボディとしてjsonデータを送信したいので、Content-Type: application/json を指定しています。

-d : リクエストボディを指定します。

引数でリクエスト先のエンドポイントを指定することも忘れないように注意です。

軽く動作確認するだけならコマンド入力で問題ありませんが、別のエンドポイントにアクセスする・正常系異常系のテストをするとなれば毎回同じコマンドを入力するのは面倒です。

シェルスクリプトでAPI実行を効率化してみましょう。 今回は ・ エンドポイント ・ リクエストで投げるJSON

を引数で受け取るようにしました。また、今回は/usr/local下にスクリプトを配置することにします。

コマンドを全て入力するよりも少ない手間でAPIを実行することができました。

今回はスクリプトのパスを通していないのでフルパスで実行していますが、パスを通しておくと更に少ない手間でAPIにアクセスできるでしょう。

また、どのようなJSONデータを使うのか予め決まっている場合はデータをjsonファイルに定義しておき、引数でファイルパスを渡すという方法も良いかもしれません。